home *** CD-ROM | disk | FTP | other *** search
/ The Net Power 1996 November / The Net Power 1996-11.iso / mac / htmled / ANT_HTML / README.TXT < prev    next >
Text File  |  1996-08-30  |  15KB  |  303 lines
  1.  
  2.  
  3.                       ANT_DEMO.DOT   Version 2.2
  4.  
  5.             DEMONSTRATION VERSION of the ANT_HTML.DOT PROGRAM
  6.  
  7.                           Word  6.0 To HTML 
  8.          PLUS  HTML to Word 6.0 WYSIWYG Conversion Utility
  9.   (or HTML To ASCII or to any other format available in WfW 6.0)
  10.  
  11.                              for use in
  12.  
  13.                  *  WORD FOR WINDOWS
  14.               *  WORD FOR MACINTOSH
  15.                     *  NT
  16.                   *  WIN 95
  17.                 *  in International Versions of Word 6.0 or above
  18.  
  19.  ______________________________________________________________________
  20.  
  21.     TWO NEW TOOLBARS AND MANY NEW FEATURES ARE INCLUDED IN VERSION 2.2 
  22.  
  23. A description of the new Ant and it's features, as well as HTML Resources
  24. and information about email and creating transparent graphic backgrounds,
  25. is now available on the Web...
  26.  
  27.                           http://mcia.com/ant
  28.  
  29.      The Ant templates are designed to work within Word 6.0 to 
  30. facilitate the creation of hypertext documents.  HTML codes can be 
  31. inserted into any new or previously prepared Word document of any ASCII
  32. document.  The templates also include:
  33.  
  34.        ~  The HTML to  WYSIWYG utility (described below)
  35.        ~  A feature which simplifies the creation of forms
  36.        ~  A tool to convert "special characters"   (e.g. cedillas, umlauts, etc.)
  37.        ~  The means to create .DOC, .ASCII, RTF or other files from HTML files.
  38.        ~  The means to make hard copies of HTML documents
  39.           with the tags removed.
  40.  
  41.      After clicking the HTML to WYSIWYG Tool on the far right of the toolbar 
  42. so that the document is properly coded, you can easily remove the codes, if 
  43. you like, while maintaining the formatting.  You may convert the file to ASCII
  44. text or to any other format listed in the "Save File As Type" options box.
  45. (Open Word and select File, Save [or File, SaveAs].  At the bottom of the dialog
  46. box, click on the File Save As Type "down arrow" to view the list.)
  47.  
  48.      By pasting the contents of any HTML document into a new Word 6.0 document
  49. based on the ANT-HTML template, you can easily and automatically convert the 
  50. file into a What-You-See-Is-What-You-Get environment by clicking the HTML To
  51. WYSIWYG Tool.  The program does not currently support nested lists, although
  52. non-nested lists of all varieties are supported.
  53.  
  54.      The template converts all HTML headings to the appropriate sizes, converts
  55. all styles, as well as bolds, italics, special characters, etc.. The template
  56. displays HTML tags as red, hidden text and displays URL entries as bright blue
  57. and underlined.
  58.  
  59.      Hard copies of HTML documents can be easily obtained with ANT_HTML. 
  60. After clicking the HTML To WYSIWYG Tool, just choose the "Zap Macros In 
  61. Entire Document" entry from the Ant Tools menu.  A WYSIWYG document without
  62. HTML tags can then be printed.
  63. ______________________________________________________________________________
  64.  
  65.                           ABOUT  THIS  TEMPLATE...
  66.  
  67. Unlike some other demonstration programs, the ANT_DEMO program is a
  68. working version of the complete program with a few exceptions. It's not timed 
  69. to self-destruct or shut down after a predetermined number of days.
  70. Instead, the Ant demo permits you access to all the tools but frequently 
  71. inserts harmless notes into the document along with the HTML tags.
  72. (Naturally, the complete programs do NOT insert any notes.)   Since the
  73. ANT_DEMO.DOT template is for demonstration purposes only, it is hoped 
  74. that you will enjoy evaluating the features and maintain a sense of humor
  75. while viewing some of the inserted notes.  (One particular quote you may
  76. see in the HTML to WYSIWYG demo, though, is to be taken seriously.
  77. The Eskimo proverb,  "Do not make Loon Soup", shall, I believe,
  78. forever remain sound advice. :-))
  79.  
  80. Were necessary, you can substitute the words, "ANT_DEMO" for the words,
  81. "ANT_HTML" when reading the tips in the Ant Instruction Guide.  
  82.  
  83. The only documentation difference in the full version is that the Ant
  84. Instruction Guide is provided in .DOC format (with Word's own hypertext
  85. links), as well as the HTML version.
  86.  
  87. The Ant_Demo program only differs from the complete versions of the
  88. programs in a few ways.
  89. ANT_HTML contains...
  90. -  the HTML to WYSIWYG utility
  91. -  the Special Characters Tool
  92. -  the Form Tool
  93. -  the Zap Codes in Selection and the Zap Codes in Entire Document Tools
  94. -  the Backgrounds and Colors Tool enters all the appropriate tags sans
  95.        the actual six digit color code
  96.  
  97. Demo versions of the HTML to WYSIWYG utility and the Form tool are
  98. provided in the demo.  To see the conversion from HTML to .DOC, click 
  99. the HTML to WYSIWYG tool (on the far right of the Ant Toolbar).  
  100. The demo will open the ANTDEMO.HTM file, copy and paste it into your 
  101. current document and WYSIWYG it.  The main portion of the program is 
  102. directed at creating and converting from .DOC to HTML.  The HTML to WYSIWYG
  103. conversions, while handy, is not as complex an operation.  The
  104. tool basically grabs whatever is between the HTML tags and assigns the
  105. appropriate styles to what's there.  It's true that some
  106. individuals register for the program strictly to use this feature
  107. but I have found it to be unwise to release a public version that
  108. doesn't provide a few incentives to register.
  109.  
  110. The other exceptions listed above are just quick and easy substitutions.
  111. The special characters tool merely converts all the standard ISO Latin 1
  112. Entities. The list of the characters is available at:
  113. http://www.hal.com/users/connolly/html-spec/spyglass-19941128/htmlspec281194_22.html
  114. and the zap codes macros merely delete the angle brackets "<", ">")
  115. and whatever is between them in the selection.
  116.  
  117. New tags added.  Please note:  <U></U> tags (for the underlining of text 
  118. supported by some HTML browsers) have been added to the complete version of
  119. the program.  Installation of the tags is optional during the conversion to
  120. HTML.  In the conversion from HTML to .DOC, text contained with <U></U> tags
  121. is automatically underlined.
  122.  
  123.  ______________________________________________________________________________
  124.  
  125.  Note to reviewers or to anyone who is contemplating writing and asking for 
  126.  a free copy of the program. 
  127.  
  128.  There are several reasons why the complete version of the Ant software is 
  129.  not distributed free of charge.  Please understand that there's just not
  130.  sufficient time to verify information sent to me.  There are additional
  131.  reasons, too, though.  I realize that this policy will (and has) 
  132.  annoyed a few people.  It seems especially to annoy large  footwear corporation
  133.  marketing supervisors, for some reason.  At any rate, the Ant has 
  134.  been favorably compared to other higher priced conversion utilities and any
  135.  review anyone encounters is assured to have been objective and unbiased one.
  136.  Each  of the reviewers or evaluators who use the program and each of the sites
  137.  that display the Ant graphic have registered and paid for the complete version
  138.  of the program.  Regardless of how unconvential the policy, it does seem to
  139.  me to be entirely reasonable and fair.
  140.  
  141.  Regardless of your goal, the demo is specifically designed to provide all the
  142.  tools and features necessary to evaluate  the program.  If you have any questions
  143.  about the program which are not answered in the documentation, please write and
  144.  let me know.  Thanks.
  145.  ______________________________________________________________________________
  146.  
  147.  
  148.                                     NOTES
  149.  
  150. The Instruction Guide for this program is offered in HTML format in the
  151. files called ANT.HTM, ANT2.HTM and ANT3.HTM.  (In the complete version
  152. of the program, the Instruction Guide is included in .DOC file format
  153. with Word's own version of hypertext links.)
  154.  
  155. Although the Instruction Guide contains many HTML tips and formatting suggestions,
  156. it is not intended as an instruction guide for HTML.  If you are already familiar
  157. with HTML coding, the features will (I hope) seem "intuitive" and enable you to
  158. click on a tool and achieve the expected result.  Basically, once the Ant template
  159. is installed...
  160.  
  161.   ... or it you wish to create an HTML file from an existing Word .DOC file. 
  162.       insert it into a new .DOC file based on the Ant template,
  163.       use the Ant Tools to code your document and click on the Convert and
  164.       Save Tool.
  165.  
  166.   ... or it you wish to create a .DOC file from an existing HTML file. just 
  167.       insert the HTML file (it will be ASCII text) into a new .DOC 
  168.       file based on the Ant template, then click on the HTML To WYSIWYG Tool.
  169.       (You can then, if you wish,  remove the HTML codes, convert to any other
  170.       format available in Word and / or print a hard copy. [See top of this
  171.       page for more.] )
  172.   
  173.   That's about all there is to it.  (Caveat in the paragraph below:)
  174.  
  175. It is suggested that you take the time to read the Tips and Notes section of
  176. the ANT.HTM Instruction Guide.  It contains a number of helpful hints about 
  177. working with HTML and the template in the Word for Windows environment.
  178. ______________________________________________________________________________
  179.  
  180. To install the ANT:
  181. 1.  Copy all the files into the same directory or folder.
  182.     (You may name it whatever you like and it can be anywhere;
  183.     just so itÆs NOT within any of your Word directories or folders.)
  184. 2.  Open Word
  185. 3.  Open the ANT_INST.DOC file and double-click the red button.  The End.
  186.                                                                                                                      
  187. Note:  You will be asked during the installation whether you would like to
  188. have a tool which attaches the Ant template to any document, automatically 
  189. installed in the Standard toolbar in your Normal.Dot template.
  190.  
  191. If you choose "YES", a tool with an "A" will be added to the Standard toolbar
  192. and will be readily available if and when you want to open and use the Ant
  193. template.  (You can easily move the tool or delete it later, if you wish.)
  194.  
  195. Just so you know, after double-clicking the red button, the Ant will 
  196. automatically perform these tasks...
  197.  
  198.    ANT_DEMO.DOT and the ANTDEMO.HTM file will be copied to your Word Templates 
  199.    Directory/Folder. A file ANT_HTML.INI, recording the local information for your
  200.    copy of the Ant, will be created in your Windows directory/Preferences folder.
  201.  
  202. ______________________________________________________________________________
  203.  
  204. To "Uninstall" the Ant
  205. If you should ever wish to "uninstall" the Ant's files, here are the steps:
  206.  1.  Delete the ANT_DEMO.DOT and the ANTDEMO.HTM files from your Word Template
  207.      directory or folder.
  208.  2.  Delete the ANT_HTML.INI file from your Windows directory/Preferences folder
  209.  3.  If you created a directory to hold the .gifs and other Ant files, delete it
  210.  4.  If there is an "Attach Ant Template" tool on your standard toolbar:
  211.      a.)  In Word for Windows: Hold down the ALT key and drag the tool off the toolbar.
  212.           In Word for Macintosh, from the Tools Menu, choose Customize and then select
  213.            the Toolbars tab, then drag the tool from the Toolbar.
  214.      b.)  In the Tools Menu, choose Macro, then click on the "Attach Ant Template" entry
  215.            and click the DELETE key.
  216. ____________________________________________________________________________
  217.  
  218. Note to users of non-English language versions of Word 6.0:
  219. The first time you make use of the Ant template, you will likely see
  220. a message asking  "Save Changes to .DOT file?"  (The .DOT file
  221. is the template itself.) 
  222.  
  223. Answer "YES" to this question so that the macros (the programming code)
  224. will be translated and saved in the appropriate language.  If you answer "NO"
  225. to the question, the translation will be required each time you open any 
  226. document based on the Ant template.
  227. ______________________________________________________________________________
  228.  
  229. Troubleshooting:
  230.  
  231. If you have trouble installing, run the ToolsAvancedSettings command from the
  232. Tools/Macros/commands menu to make sure you have an entry for "USER-DOT-PATH" 
  233. in your WINWORD6.INI (Windows) or WORD SETTINGS (6) file (Mac).
  234.  
  235. ______________________________________________________________________________
  236.  
  237.  
  238. More Notes :
  239.  - The templates are not represented to be perfect. They are designed to make 
  240.    working with hypertext faster and easier.
  241.  - The Ant Instruction Guide may be found in ANT.HTM.
  242.    You may wish to create a directory for the guide and it's gifs.
  243.    (There are many gif files depicting toolbar tools so, for faster loading, 
  244.    you can turn "Display Inline Images" off in your HTML browser if you wish.)
  245.  - A  .DOC version of the Instruction Guide (with hyperlinks, graphics and other
  246.    Word formatting features) is included in the ANT_HTML package. 
  247.    
  248.  
  249. The program is nominally priced shareware program.
  250. For individual registration:
  251. $39.00  or
  252. If you're currently registered - $15.00 (individual use).
  253. To register and obtain the complete version of the program:
  254.  
  255. 1. Send your name, address, email address.
  256. 2. Send the registration fee (per copy)
  257.    -  Within the U.S.:  via check, traveler's check, or money order
  258.    -  Outside the U.S.: via traveler's check, U.S. dollar draft, cash,
  259.       or international money order.
  260.   (Sorry, no plastic options are currently available.)
  261. 3. Please specify your preference of BinHex, MIME or UUEncoding.
  262.    A personalized copy of the program will be sent to you as a zip file
  263.    email attachment. 
  264.   
  265. Please specify your preference of BinHex, MIME or UUEncoding.
  266. Information about encoding can be found at:
  267.     http://mcia.com/ant/email.htm
  268.  
  269. Registration Notes:
  270.  - If the program is sent to an address within the State of Texas,
  271.    please add $3.00 per copy.
  272.  - If your email service does not permit zip file attachments, please
  273.    send a disk and stamped, self-addressed disk mailer to the
  274.    P.O. Box below.  A copy of the program will be snail-mailed to you.
  275.    (If you are using a Macintosh, please mention it so that the files can
  276.    be sent uncompressed rather than zipped. The disk itself will be
  277.    formatted on a PC.)
  278.  - If you don't want the program delivered via email and you don't
  279.    want to bother about sending a disk and stamped, self-addressed disk mailer, 
  280.    send an additional $10.00 (deliveries within the U.S.) - or $15.00 (deliveries 
  281.    outside the U.S.) and it shall be done for ye.
  282.   -If you don't have an email address, please provide ANY email address or 
  283.    some reasonable, non-costly way to contact you just in case your registration 
  284.    arrives half-eaten.
  285.  - ftp delivery is also available.  Please send (typed for readability),
  286.    the address of the ftp server, the directory path, and the login and password.
  287.  
  288. The copyright notice can be found in the ANT.HTM Instruction Guide. 
  289.  
  290. ______________________________________________________________________________
  291.  
  292. Thanks to all of you who have sent friendly words, suggestions and questions. 
  293. Your messages are much appreciated.
  294.  
  295. Jill Swift
  296. Ant author
  297. P. O. Box 213
  298. Montgomery, Texas  77356
  299.  
  300. jswift@freenet.fsu.edu
  301.  
  302. October 5, 1995
  303.